home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 010a / cdm10.zip / CDM.DOC < prev    next >
Text File  |  1991-11-29  |  32KB  |  779 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                  CD Master (CDM)
  11.  
  12.                                    Version 1.0
  13.  
  14.                                  Copyright 1991
  15.  
  16.                                All Rights Reserved
  17.  
  18.                                        by
  19.  
  20.                            New-Ware Shareware Products
  21.                                8050 Camino Kiosco
  22.                                San Diego, CA 92122
  23.                                  (619) 455-6225
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                                   Contents
  37.  
  38.  
  39.            1  General  . . . . . . . . . . . . . . . . . . . . . . . .  2
  40.               1.1  Disclaimer  . . . . . . . . . . . . . . . . . . . .  2
  41.               1.2  Registering CDM . . . . . . . . . . . . . . . . . .  2
  42.            2  What Is CDM? . . . . . . . . . . . . . . . . . . . . . .  3
  43.               2.1  What Does It DO?  . . . . . . . . . . . . . . . . .  3
  44.               2.2  How Does It Do It?  . . . . . . . . . . . . . . . .  4
  45.            3  Operating CDM  . . . . . . . . . . . . . . . . . . . . .  4
  46.               3.1  Getting Help  . . . . . . . . . . . . . . . . . . .  5
  47.               3.2  Main Display  . . . . . . . . . . . . . . . . . . .  5
  48.               3.3  The Drive Menu  . . . . . . . . . . . . . . . . . .  6
  49.                  3.3.1  New Drive - F3 . . . . . . . . . . . . . . . .  6
  50.                  3.3.2  Re-Scan - F5 . . . . . . . . . . . . . . . . .  6
  51.                  3.3.3  Print Tree - F7  . . . . . . . . . . . . . . .  7
  52.                  3.3.4  Drive Stats - F8 . . . . . . . . . . . . . . .  7
  53.                  3.3.5  Search - Alt+S . . . . . . . . . . . . . . . .  7
  54.               3.4  Directory Menu  . . . . . . . . . . . . . . . . . .  8
  55.                  3.4.1  Add Dir - Ins  . . . . . . . . . . . . . . . .  8
  56.                  3.4.2  Delete Dir - Del . . . . . . . . . . . . . . .  8
  57.                  3.4.3  View Files - F4  . . . . . . . . . . . . . . .  8
  58.                  3.4.4  Rename Dir - F6  . . . . . . . . . . . . . . . 10
  59.                  3.4.5  Prn File List - F9 . . . . . . . . . . . . . . 10
  60.                  3.4.6  Dir Stats - F10  . . . . . . . . . . . . . . . 10
  61.               3.5  The View Menu . . . . . . . . . . . . . . . . . . . 10
  62.            4  Mouse Support  . . . . . . . . . . . . . . . . . . . . . 11
  63.            5  Viewing/Browsing Files . . . . . . . . . . . . . . . . . 11
  64.            6  Configuring CDM  . . . . . . . . . . . . . . . . . . . . 11
  65.            7  System Requirements & Program Limitations  . . . . . . . 13
  66.            8  Technical Support  . . . . . . . . . . . . . . . . . . . 13
  67.               8.1  New-Ware BBS  . . . . . . . . . . . . . . . . . . . 13
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.                                         i
  82.  
  83.  
  84.  
  85.  
  86.  
  87.    1  General
  88.  
  89.  
  90.    1.1  Disclaimer
  91.  
  92.         New-Ware hereby disclaims all warranties relating to this product,
  93.    whether express or implied, including without limitation any implied
  94.    warranties of merchantability or fitness for a particular purpose. New-Ware
  95.    cannot and will not be liable for any special, incidental, consequential,
  96.    indirect or similar damages due to loss of data or any other reason, even
  97.    if New-Ware or an authorized New-Ware agent has been advised of the
  98.    possibility of such damages.  In no event shall the liability for any
  99.    damages ever exceed the price paid for the license to use software,
  100.    regardless of the form and/or extent of the claim.  The user of this
  101.    program bears all risk as to the quality and performance of the software.
  102.  
  103.    1.2  Registering CDM
  104.  
  105.         CDM is a Shareware product which means that it is provided for you to
  106.    use on a "try before you buy basis".  If you do not find CDM useful, then
  107.    simply stop using it.  If you do find CDM useful then you should register
  108.    it.  Registration can be accomplished via mail, telephone, or BBS.  Simply
  109.    fill out the form below and mail or phone in the appropriate information.
  110.  
  111.         /-------------------------------------------------------------\
  112.         │                   CDM Registration Form                     │
  113.         │                                                             │
  114.         │   Name:_________________________________________________    │
  115.         │                                                             │
  116.         │   Address:______________________________________________    │
  117.         │                                                             │
  118.         │   City/State:_____________________________ ZIP _________    │
  119.         │                                                             │
  120.         │   MC/Visa #_______________________________ EXP _________    │
  121.         │                                                             │
  122.         │   Enclosed is my check or my MasterCard/Visa card number    │
  123.         │   for the amount of $15.00.                                 │
  124.         │                                                             │
  125.         │   California residents must include 8.25% ($1.24) sales     │
  126.         │   tax.  Foreign orders must include $2.00 for shipping.     │
  127.         │                                                             │
  128.         \_____________________________________________________________/
  129.  
  130.         Users may also register via the New-Ware BBS which operates at
  131.    1200/2400 baud 24 hours per day at (619) 455-5226.  After connecting and
  132.    logging in as a new BBS user you can register CDM with a valid MasterCard
  133.    or Visa number via the BBS Questionnaire menu.
  134.  
  135.  
  136.  
  137.  
  138.                                       - 2 -
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.         NOTE:  The Shareware evaluation copy of CDM is functionally identical
  146.    to the registered version copy.  The only difference is that a Shareware
  147.    information screen will pop up approximately once in every five major
  148.    commands issued from the main directory tree display.  This screen does not
  149.    inhibit the functionality of CDM in any way but is included as a gentle
  150.    reminder to evaluating users that CDM is indeed a Shareware product..
  151.  
  152.         NOTE:  All users that register CDM, including those who register via
  153.    BBS, will receive a registered copy of the current version on disk via
  154.    mail.  Please specify if you require a 3 1/2" diskette.
  155.  
  156.         NOTE:  The New-Ware voice line, (619) 455-6225, is served by a voice
  157.    mail system that will answers calls in the absence of New-Ware personnel.
  158.    This voice mail system has sufficient security to permit you to leave a
  159.    MasterCard or Visa order without fear of card data compromise.
  160.  
  161.         NOTE:  Users that register by mail or voice telephone are NOT
  162.    automatically entered into the BBS registered user database.  To gain
  163.    access to the registered CDM file and to the exclusive registered user's
  164.    node (9600 baud HST) you must first log on the open node and leave the
  165.    Sysop a comment requesting access as a registered CDM user.
  166.  
  167.         NOTE: Special site license rates are available.  Please call for
  168.    further information.
  169.  
  170.  
  171.    2  What Is CDM?
  172.  
  173.  
  174.    2.1  What Does It DO?
  175.  
  176.         CDM, an abbreviation for CD Master (the CD represents the DOS Change
  177.    Directory command), is a utility designed to facilitate navigating around
  178.    the different drives and directory trees of you computer system.  Most
  179.    computer systems have multiple drives with fairly complex subdirectory
  180.    structure on each drive.  CDM provides a fast, powerful, and easy to use
  181.    interface for moving about and maintaining the directory structures of your
  182.    system.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                       - 3 -
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.    2.2  How Does It Do It?
  204.  
  205.         Each time you run CDM it presents a graphical display of the directory
  206.    tree structure of the current drive in a treelike format as in the example
  207.    below:
  208.  
  209.                              ╒══ Drive D: Tree ══╕
  210.                              │├───FM             │
  211.                              │├───FMTSR          │
  212.                              │├─┬─NEWFILER       │
  213.                              ││ ├───INC          │
  214.                              ││ ├───INS          │
  215.                              ││ ├───OBJ          │
  216.                              ││ ├───PAS          │
  217.                              ││ ├───REAL         │
  218.                              ││ └───TPU          │
  219.                              │├─┬─OP             │
  220.                              ││ ├───EX           │
  221.                              ││ ├───INC          │
  222.                              ││ ├───OBJ          │
  223.                              ││ ├───PAS          │
  224.                              ││ ├───SAVE         │
  225.                              ││ └───TPU          │
  226.                              │├───RE             │
  227.                              │├───REFDATA        │
  228.                              │├───SPRINT         │
  229.                              ╘═══════════════════╛
  230.  
  231.         When it executes, CDM will either scan the current disk to build and
  232.    sort the tree structure for you or it will access a file where this data is
  233.    maintained.  Each time a new drive is accessed, the tree for the new drive
  234.    is displayed.  You can change drives while in CDM and go directly to a
  235.    specific directory on the new drive.  A number of useful functions are
  236.    accessible from main display via pull-down menus, function keys, or mouse
  237.    clicks.
  238.  
  239.  
  240.    3  Operating CDM
  241.  
  242.  
  243.         It is strongly suggested that CDM.EXE be placed in a directory that is
  244.    identified in your DOS PATH string so that it will be accessible from any
  245.    place in your system.
  246.  
  247.         Execute CDM by typing CDM at the DOS prompt and press the Enter key.
  248.    CDM will load and display the directory tree for the current drive.  Or you
  249.    may add a drive letter and colon, i.e., X:, where X is the drive designator
  250.  
  251.  
  252.  
  253.  
  254.                                       - 4 -
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.    of the target drive.  In that case CDM will display the directory tree for
  262.    drive X.
  263.  
  264.         You may also add the name or partial name of a subdirectory.  For
  265.    example, suppose you have a directory with the path name of
  266.    D:\UTILITY\ARCHIVE\ZIPPROG\DAT that you wish to change to.  If you are
  267.    already on drive D:, simply type CDM dat and press Return.  CDM will load
  268.    and position the cursor bar over the DAT subdirectory.  Now press Return to
  269.    change to that subdirectory and return to the DOS level.  Or if you are not
  270.    on drive D:, typing D:dat will accomplish the same thing.  One thing to
  271.    remember about this feature is that CDM will search the sorted tree in a
  272.    top-down fashion.  In the case of the example above, this means that if you
  273.    had a subdirectory named D:\ALLDONE\DAT, CDM would place the cursor bar on
  274.    this subdirectory instead of the longer one because it appears first in the
  275.    tree.  To handle such cases, use the Ctrl+L command.  This will continue
  276.    the search until the next match is found.
  277.  
  278.    3.1  Getting Help
  279.  
  280.         CDM provides on-line help via the F1 key and the file named CDM.HLP.
  281.    If you place CDM.HLP (along with CDM.EXE) in a directory that is in your
  282.    DOS PATH, pressing the F1 key will bring up a help window.  If you press F1
  283.    while in the main tree display, a Help Topic window will appear.  Select a
  284.    topic and press the Enter key get help on a specific topic.  Help is also
  285.    available from the file list viewing windows and from the directory stats
  286.    window.
  287.  
  288.    3.2  Main Display
  289.  
  290.         The main display will always contain a window that occupies the left
  291.    side of the screen in which the directory tree structure will be displayed.
  292.    The window width will automatically be adjusted to accommodate trees with
  293.    long directory names and multiple depths.  The height of the window will be
  294.    proportional to the number of lines in the display.  EGA/VGA users may
  295.    elect to operate in a 44(EGA)/50(VGA) line mode.
  296.  
  297.         The top line of the display contains a bar that contains the following
  298.    command cues:
  299.  
  300.                                  Drive -   - Alt+D
  301.                                  diRectory - Alt+R
  302.                                  View      - Alt+V
  303.  
  304.         Pressing the Alt key and D, R, or V will activate one of three pull
  305.    down menus.  If you have a mouse you may click the mouse over any of the
  306.    cues to obtain the desired menu.
  307.  
  308.  
  309.  
  310.  
  311.  
  312.                                       - 5 -
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.         The bottom line of the display normally contains the "Alt+X to Quit"
  320.    cue.  Press Alt+X or click with the mouse over the cue exits the program
  321.    with no action.
  322.  
  323.    3.3  The Drive Menu
  324.  
  325.         The Drive pull-down menu offers the following six choices:
  326.  
  327.                             ╒════════════════════╕
  328.                             │ New Drive      F3  │
  329.                             │ Re-Scan        F5  │
  330.                             │ Print Tree     F7  │
  331.                             │ Drive Stats    F8  │
  332.                             │ Search      Alt+S  │
  333.                             ╘════════════════════╛
  334.  
  335.    Notice that each item shows a function or Alt key command that may be used
  336.    directly from the main display without going through this menu.  All menus
  337.    in CDM operate by moving the cursor bar to the desired item and pressing
  338.    the Enter key (or left-clicking the mouse).
  339.  
  340.    3.3.1  New Drive - F3
  341.  
  342.         CDM will display a menu of all the valid drives found in your system.
  343.    This includes ram drives and floppy disk drives.  Select a drive from the
  344.    menu by pressing the Enter key with cursor over the target drive or by
  345.    pressing the drive designator character.  CDM will immediately attempt to
  346.    load and display the directory tree structure for that drive.  Note that
  347.    each time CDM is executed or a new drive is selected, the directory tree
  348.    cursor will automatically move to the currently active directory name.
  349.  
  350.         If a drive is empty or otherwise reported by DOS as being not ready,
  351.    CDM will show an empty directory tree.
  352.  
  353.    3.3.2  Re-Scan - F5
  354.  
  355.         CDM can be operated in two basic modes.  In one mode, CDM scan the
  356.    drive to build the directory tree each time a drive is accessed.  This is
  357.    slow, especially in the case of large drives with lots of directories, but
  358.    it always shows the current state of the directory tree structure.  CDM
  359.    provides an alternative to this by maintaining small files that contain an
  360.    abbreviated image of each drive tree structure.  These files are named
  361.    NEW-WARE.X, where X is the drive designator.  In order to use this
  362.    strategy, you must configure CDM to recognize a valid directory in your
  363.    system as the repository for these files.  Then CDM only needs to briefly
  364.    read in the data that describes the tree structure when accessing a drive
  365.    instead of spending seconds re-scanning the drive.  Any time you elect to
  366.    add, remove, or rename a directory via CDM, the appropriate tree data file
  367.  
  368.  
  369.  
  370.                                       - 6 -
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.    is automatically updated.  If, however, you add, remove, or rename a
  378.    directory via a means other than CDM the tree data will no longer be valid.
  379.    That is why the F5 command is included.  You can re-scan any drive at any
  380.    time to update a tree data file and CDM will operate much, much faster.
  381.  
  382.    3.3.3  Print Tree - F7
  383.  
  384.         This function is provided so that you can print a copy of the
  385.    directory tree structure.  Please be sure that your printer is in the full
  386.    ready mode and that it will properly print the IBM line drawing characters
  387.    used to depict the tree structure.
  388.  
  389.    3.3.4  Drive Stats - F8
  390.  
  391.         The Drive Stats function displays a window in the right side of the
  392.    display that contains interesting information concerning the current drive.
  393.    On slower systems with a large drive, this function might take a few
  394.    seconds to retrieve all the data that it displays.
  395.  
  396.    3.3.5  Search - Alt+S
  397.  
  398.         CDM offers a fast means of finding a specific file on a drive.  When
  399.    you activate the search mode, CDM will traverse the current drive tree to
  400.    collect all the file names on the drive into memory.  An advisory message
  401.    on bottom bar will appear during the scan.  Then you will be prompted on
  402.    the bottom bar to enter the target file name.  You may press the Esc key at
  403.    this point to abort the operation.
  404.  
  405.         If you enter a file name (no wild cards, please), CDM will rapidly
  406.    search the in-memory list.  If the file is found, a file list window will
  407.    appear in the right side of the display with the cursor bar positioned over
  408.    the target file name.  If the file is not found, an advisory message is
  409.    issued.  Press any key to clear the message and return to the target file
  410.    name prompt.
  411.  
  412.         You can enter the file list window without conducting a search by
  413.    simply pressing the Enter key at the prompt.  The window will open and you
  414.    will be able to browse the entire file list.  In addition, you can now use
  415.    the fast, powerful CDM speed search method of looking for files.  Notice
  416.    that the directory path name of the directory that contains the file
  417.    highlighted by the cursor bar is displayed just below the lower left hand
  418.    corner of the file window.  You may press the Enter key to view the file
  419.    under the cursor.  You may exit the file list window with the Esc key.
  420.    Notice that the directory containing the file under the cursor bar when the
  421.    Esc key is pressed will be highlighted in the tree display.
  422.  
  423.         Please see the paragraph entitled "View Files  -  F4" for information
  424.    on how the F2 through F6 keys change the file sort and for the use of the
  425.  
  426.  
  427.  
  428.                                       - 7 -
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.    F8 key to display 4DOS (or NDOS) file descriptions maintained in the
  436.    DESCRIPT.ION file.
  437.  
  438.    3.4  Directory Menu
  439.  
  440.         The Directory Menu functions are the primary means for altering the
  441.    directory tree structure.  You can add, remove, or rename any directory on
  442.    the tree providing all the DOS rules for doing so are complied with.  Here
  443.    is the menu accessed through the Alt+R command:
  444.  
  445.                             ╒══════════════════════╕
  446.                             │ Add Dir       - Ins  │
  447.                             │ Delete Dir    - Del  │
  448.                             │ View Dir      -  F4  │
  449.                             │ Rename Dir    -  F6  │
  450.                             │ Prn File List -  F9  │
  451.                             │ Dir Stats     -  F10 │
  452.                             ╘══════════════════════╛
  453.  
  454.    3.4.1  Add Dir - Ins
  455.  
  456.         Adding a subdirectory to the current tree is quite simple and
  457.    straightforward.  Press the Ins key to activate the add directory function.
  458.    The new directory will be added as a subdirectory to the directory
  459.    highlighted when you activated the command.  For example, if the cursor was
  460.    highlighting a directory on the tree with the path name C:\UTILS\CONFIG and
  461.    you typed in the name SAVE at the prompt and pressed the Enter key, CDM
  462.    would create a new subdirectory with the DOS name of C:\UTILS\CONFIG\SAVE.
  463.    Note that the tree will be immediately resorted and updated if the addition
  464.    was successful.  There are two things that might cause a failure to add a
  465.    subdirectory.  One is to enter a name that results in a full path name
  466.    identical to one already on the drive.  The other is to enter an invalid
  467.    DOS directory name.
  468.  
  469.    3.4.2  Delete Dir - Del
  470.  
  471.         You may remove any directory from the current tree structure provided
  472.    that it does not contain any files or subdirectories.  Pressing the Del key
  473.    will remove the directory under the cursor bar if DOS permits its removal.
  474.    Otherwise, an error message will be issued.  If the directory is
  475.    successfully removed, the tree will be re-sorted and updated.
  476.  
  477.    3.4.3  View Files - F4
  478.  
  479.         This function is one of the most useful available in CDM.  When the
  480.    View Files function is selected, and new vertical window will open on the
  481.    right side of the display that contains a list of file names found in the
  482.    directory under the cursor in the tree window.  This window also has a
  483.  
  484.  
  485.  
  486.                                       - 8 -
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.    cursor bar that can be moved through the list with the cursor pad keys
  494.    and/or mouse.
  495.  
  496.         A file name speed search function is a available in this mode by
  497.    pressing the letter keys of the file name you are searching for one at a
  498.    time.  For example, suppose you are interested in a file named BIGDATA.DOC.
  499.    Pressing the "B" key will move the cursor to the first file in the list
  500.    that begins with the letter "B".  Notice that as you press the letter keys
  501.    the file name is incrementally displayed in the lower left hand corner of
  502.    the window.  You can clear the speed search by moving the cursor or
  503.    pressing the backspace key.
  504.  
  505.         A file may be viewed (browsed) by pressing the Enter key (or clicking)
  506.    with the cursor bar over the desired file.  A more detailed explanation of
  507.    this feature appears latter in this document.
  508.  
  509.         You do not have to return to the tree display to view files in other
  510.    directories in the tree.  Press the F9 or Ctrl+PgUp key to move up the tree
  511.    one directory or the F10 or Ctrl+PgDn key to move down the tree.  The tree
  512.    cursor will update and the file list window will be updated with the new
  513.    list of files.  The faster your drive system and your CPU is, the more
  514.    smooth the transition between directories with large file lists will be.
  515.  
  516.         Press the Esc key to leave the file view window and return to your
  517.    original starting point on the tree.  Notice that the tree cursor will be
  518.    positioned over the directory that was active when you pressed the Esc key.
  519.  
  520.         Five different file name sorts are available in conjunction with
  521.    either ascending or descending sort logic.  The default sort at start-up is
  522.    by file name and ascending unless overridden via the CDM.CFG file.  Use the
  523.    following keys to dynamically change the sort as indicated below:
  524.  
  525.                        F2  -  Sort by file name
  526.                        F3  -  Sort by file extension
  527.                        F4  -  Sort by file date
  528.                        F5  -  Sort by file size
  529.                        F6  -  Sort by file name/extension
  530.                        F7  -  Reverse the sort direction
  531.  
  532.         Note that large file lists and/or a relatively slow CPU can result in
  533.    a delay while the sort is executing.  You will notice that the cursor bar
  534.    disappears during the interval the sort is taking place.
  535.  
  536.         The F6 key activates what I call a "nested" sort.  It groups files by
  537.    file extension and sorts by file name within the extension groups.  The F7
  538.    key toggles the sort direction from it's current state to the logical
  539.    opposite.  The two states are ascending and descending.
  540.  
  541.  
  542.  
  543.  
  544.                                       - 9 -
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.         4DOS and NDOS users can use the F8 key to display an existing file
  552.    comment.  Note that a comment related to the file must exist in the
  553.    DESCRIPT.ION file that resides in the host directory for the target file.
  554.  
  555.    3.4.4  Rename Dir - F6
  556.  
  557.         This command permits you to rename a directory on the tree.  Notice
  558.    that the prompt that is issued contains the current name of the directory
  559.    and that just pressing a key will clear the entry and start a new one.  Or
  560.    you may use the backspace or arrow keys to edit the entry accordingly.  The
  561.    only thing that will cause the rename function to fail is if your new name
  562.    entry results in a path name of an existing directory on that drive.
  563.  
  564.    3.4.5  Prn File List - F9
  565.  
  566.         A sorted listing of all the files contained in the directory under the
  567.    tree cursor bar may be obtained by pressing activating this function.
  568.    Please be sure the printer is ready to print before using this function.
  569.  
  570.    3.4.6  Dir Stats - F10
  571.  
  572.         The directory stats function is somewhat similar to the drive stats
  573.    function except that it displays data relating to the directory under the
  574.    tree cursor bar.  Also, note that if the highlighted directory is a
  575.    subtree, i.e., it contains subdirectories, CDM will display the data for
  576.    the entire subtree in the lower half of the display window.  Like the file
  577.    view command (F4) explained earlier, you may move up and down the directory
  578.    tree with the F9/F10 keys respectively.  Note that if you move the cursor
  579.    to the root directory at the top of the tree, the subtree data is now for
  580.    the entire drive.
  581.  
  582.    3.5  The View Menu
  583.  
  584.         The View Menu provides a means for toggling an EGA or VGA display
  585.    between the normal 25 line mode and a 43/50 line mode.
  586.  
  587.                                  ╒═══════════╕
  588.                                  │ 25 lines  │
  589.                                  │ 50 lines  │
  590.                                  ╘═══════════╛
  591.  
  592.           Note that pressing the F2 key while in the main tree display also
  593.    toggles between the two types of displays.  CDM can be configured to
  594.    automatically switch to a 43/50 line mode at run time.  This is explained
  595.    later.  If the display is already in a 43/50 line mode upon entry, it will
  596.    automatically adjust.
  597.  
  598.  
  599.  
  600.  
  601.  
  602.                                      - 10 -
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.    4  Mouse Support
  610.  
  611.  
  612.         CDM fully supports all mouse systems that are compatible with the
  613.    Microsoft two-button mouse standard.  It will save the current system mouse
  614.    state upon entry and restore it upon exit so as not to perturb your default
  615.    settings.
  616.  
  617.         You may use the mouse to traverse the graphic tree, traverse file
  618.    lists, access menus, select menu items, etc.  If a system mouse is detected
  619.    at runtime, CDM will display four additional mouse cues on the bottom line
  620.    of the display.  These cues can be clicked on to perform the indicated
  621.    function.  When operating within the tree or file windows, you may move the
  622.    cursor by positioning the mouse cursor at a desired line and then pressing
  623.    the left button.  If the left button is pressed with the mouse cursor on
  624.    the cursor bar it is the same as pressing the Enter key.  Pressing the
  625.    right button is always the same as pressing the Esc key.  The middle key on
  626.    a three-button mouse is not recognized.
  627.  
  628.  
  629.    5  Viewing/Browsing Files
  630.  
  631.  
  632.         CDM provides an interface to the file viewer of your choice.  It will
  633.    call Vern Buerg's famous LIST viewer as a default or you may configure CDM
  634.    to use any other viewer.  You must ensure that whichever viewer you desire
  635.    to use resides in a directory that is identified in the DOS PATH string.
  636.  
  637.         To view a file, enter one of the file list viewing modes, move the
  638.    cursor bar to the desire file, and press the Enter Key or left click the
  639.    mouse.  CDM will issue a call to the designated viewer with the name of the
  640.    selected file as a command line argument.  Note that the LIST /m (for use
  641.    mouse) switch is not passed so you must preconfigure LIST to use the mouse.
  642.    CDM will devote the full display for viewing/browsing the target file and
  643.    then restore its display upon exit from the viewer.
  644.  
  645.  
  646.    6  Configuring CDM
  647.  
  648.  
  649.         You may cause CDM to use certain default modes at start-up via the
  650.    CDM.CFG file.  This is a simple ASCII text file that you create/modify to
  651.    cause CDM to use specified defaults.  Since CDM must be able to locate
  652.    CDM.CFG at runtime, you should position your CDM.CFG file in the DOS PATH.
  653.    The simplest and best way to do this is to place both CDM.EXE and CDM.CFG
  654.    in the same directory and ensure that directory is in the DOS PATH.
  655.  
  656.  
  657.  
  658.  
  659.  
  660.                                      - 11 -
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.         Here is an example of what the file can look like.  You will need a
  668.    text editor (like the fabulous QEDIT) to create/modify this file:
  669.  
  670.         dirlog=c:\log; where to store drive directory tree data files
  671.         forcemono=false; primarily for use with certain laptop monitors
  672.         vidlines=25; anything but 25 will force into 43(EGA)/50(VGA) line mode
  673.         viewer=list;  name of file viewer
  674.         nosort=false; do not sort the directory tree
  675.         filesort=4; default sort is by size
  676.         files=false; if TRUE then always start CDM in the file view (F4) mode
  677.         tree=true; if FALSE, change directory only - do not display tree.
  678.  
  679.         Values for the "filesort=" item will set the start-up default file
  680.    sort method as follows:
  681.  
  682.                        1  =  Sort by file name
  683.                        2  =  Sort by file extension
  684.                        3  =  Sort by file date
  685.                        4  =  Sort by file size
  686.                        5  =  Sort by file extension/name
  687.  
  688.         Please ensure that each line of the file, if included, looks like the
  689.    example above.  The lines can be in upper or lower case but there must be
  690.    NO spaces between the command, equal signs, and arguments.  The file may
  691.    contain one or more of the above lines.  Comments can be added to each line
  692.    by using a semicolon delimiter as shown above.  Any text following the
  693.    semicolon will be ignored.
  694.  
  695.         Note that if the "dirlog=" argument is empty or is an invalid
  696.    directory path name, CDM will NOT use the directory data file storage
  697.    strategy and disk access will slow things down.
  698.  
  699.         If no CDM.CFG file is found by CDM at runtime, the following defaults
  700.    are in effect:
  701.  
  702.         DirLog=C:\LOG
  703.         ForceMono=false
  704.         VidLines=25 (but will adjust automatically to current system value)
  705.         Viewer=LIST
  706.         NoSort=false
  707.  
  708.         Laptop owners may find the colors of CDM to be unacceptable.  If that
  709.    is the case you may force a mono (two-color) mode by placing the line
  710.    ForceMono=true in the file.
  711.  
  712.         Note that there is a sample CDM.CFG file in the distribution package.
  713.  
  714.  
  715.  
  716.  
  717.  
  718.                                      - 12 -
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.    7  System Requirements & Program Limitations
  726.  
  727.  
  728.         CDM is designed to operate on any IBM PC compatible computer running
  729.    DOS 2.1 or higher with 300K of RAM available at runtime.  CGA, EGA, VGA and
  730.    monochrome monitors are supported.  CDM can support up to 700 directories
  731.    per drive.  The number of files per directory/drive is strictly dependent
  732.    upon available memory, but will range from approximately 4500 with 300K to
  733.    18,000 with 620K (not improbable with DOS 5.0 and QEMM!).
  734.  
  735.         Any mouse compatible with Microsoft Systems mouse version 6.0 and
  736.    above is supported.
  737.  
  738.         Any printer that supports printing of IBM line characters can be used
  739.    to print the directory tree.
  740.  
  741.  
  742.    8  Technical Support
  743.  
  744.  
  745.         Technical support is available from 8 a.m to 5 p.m. Pacific time on
  746.    Monday through Saturday via telephone at (619) 455-6225.  Please note that
  747.    messages left on New-Ware voice mail by non-registered users requesting a
  748.    return call for support will not be responded to.
  749.  
  750.    8.1  New-Ware BBS
  751.  
  752.         New-Ware operates a Bulletin Board System (BBS) which can be accessed
  753.    for technical support, copy of latest version, and on-line product
  754.    registration.  Registered users of any New-Ware products have access to a
  755.    closed line served by a U.S. Robotics HST Courier 9600 baud modem as well
  756.    as to the standard 2400 baud line.  The BBS operates 24 hours a day on
  757.    these two lines:
  758.  
  759.              Node #1 - (619) 450-3257 - Registered Users Only
  760.              Node #2 - (619) 455-5226 - All callers
  761.  
  762.         Those users who register by voice telephone or by mail are NOT
  763.    automatically entered into the registered user database and MUST call node
  764.    #2 and leave a comment for the sysop requesting registered status.
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.                                      - 13 -
  777.  
  778.  
  779.